Cocktail API icon
Free API JSON CocktailDB

Support

The API and site will always remain free to access at its basic level.

Test Key

Use the test API key 1 during development or educational use.

For production use, sign up for Premium API if you are releasing publicly.

Go Premium (£10)

Contact

Email: [email protected]

Free Cocktail API Guide

Here are the main JSON endpoints for TheCocktailDB. They should work directly in a web browser or any API test tool such as postman or httpie. Most of the API is free, but we do offer a few premium calls for a one off upgrade.

Test key: 1 Base URL: www.thecocktaildb.com/api/json/v1/APIKEY/ Premium features available

V1 API Methods

Search cocktail by name

Search cocktail by first letter

Search ingredient by name

Lookup full cocktail details by id

Lookup ingredient by id

Lookup a random cocktail

Lookup a selection of 10 random cocktails

Premium API only (free limited to 1)

£10 lifetime upgrade

List popular cocktails

Premium API only (free limited to 1)

£10 lifetime upgrade

List most recent cocktails

Premium API only (free limited to 1)

£10 lifetime upgrade

Search by ingredient

Filter by multiple ingredients

Premium API only (free limited to 1)

£10 lifetime upgrade

Filter by alcoholic category

Filter by category

Filter by glass

List categories, glasses, ingredients, or alcoholic filters

Premium access
Upgrading unlocks extra filter combinations, popular and recent lookups, the full database listing, and the latest/random image API methods.

Images

Drink thumbnails

Add /small, /medium, /large to the end of the cocktail image URL.

Cocktail small thumbnail Cocktail medium thumbnail Cocktail large thumbnail

Ingredient thumbnails

Add /small, /medium, /large to the end of the ingredient image URL.

Gin thumbnail Gin medium thumbnail Gin large thumbnail